5.2.1 创建提款至MINPAY钱包订单

#简要描述：将人民币或数字币提现到钱包的提现业务接口，让用户能够将账户余额转移到指定的钱包地址

请求方式: POST
请求接口: https://网关域名/wallet-trade-merchant/v1/pay/wallet/create
请求媒体类型( JSON 数据格式 )Content-Type: application/json

请求参数

参数名称	类型	必填	参数含义	参数说明
key	string	是	商户 key	apiKey
localOrderId	string	是	商户平台本地订单号	商户平台本地生成唯一订单号
localUserId	string	否	商户平台本地用户ID	商户平台本地用户ID
amount	number	是	订单金额	提款金额
email	string	否	提现邮箱	用户邮箱(与用户 ID2 选 1)
userId	string	否	用户 id	用户邮箱(与用户 ID2 选 1)
notifyUrl	string	否	回调地址	下单成功后，由 API 回调通知商户的地址（回调详情参照文档3）
currency	string	是	支持币种	币种(钱包支持币种)
successRedirectUrl	string	否	地址	成功后自动跳转地址
expireSecond	Long	否	过期时间戳（秒）
sign	string	是	签名	详情见签名算法

请求 json 样例

{
  "key": "08SaKUwNafSOc8w7",
  "localOrderId": "2023102400684344447",
  "localUserId": "302199873005",
  "email": "diamond8888@gmail.com",
  "amount": "100",
  "currency": "CNY",
  "successRedirectUrl": "WWW.BAIDU.COM",
  "notifyUrl": "www.baidu.com/notify/callback",
  "sign": "41c48ea2951934626b4435f02aecf732"
}

响应 json 示例

{
  "code": 0,
  "success": true,
  "message": "string",
  "data": {
    "orderId": "2023102400684344447",
    "localOrderId": "2023102400684344447",
    "localUserId": "302199873005",
    "withdrawBizType": "WITHDRAW_WALLET",
    "orderType": "PAYMENT",
    "toUserId": 4603
  }
}

响应data 参数说明

参数名称	类型	参数含义	备注
orderId	string	订单 ID
localUserId	string	商户本地用户 ID
localOrderId	string	商户本地订单号
orderType	enum	订单类型	`PAYMENT：支付订单WITHDRAW：提款订单`
orderBizType	enum	订单业务类型	orderBizType 类型说明如下
toUserId	number	收款用户ID	MINPAY钱包用户ID

orderBizType 类型说明：

1、PAYMENT_WALLET_SCAN MINPAY钱包扫码支付
2、PAYMENT_TRANSFER 数字币绑定地址直充
3、PAYMENT_ANY_DIGITAL_SCAN 数字币任意金额扫码支付
4、WITHDRAW_WALLET 提款至MINPAY钱包
5、WITHDRAW_ANY_DIGITAL_WALLET 提款数字币至任意钱包
6、PAYMENT_FIXED_DIGITAL_SCAN 数字币限定金额扫码支付
7、BATCH_PAY 批量代付

回调返回 json 数据

默认所有回调参数参与验签，回调参数详情请看回调

回调 data

{
"amount":"4",
"bizType":"WITHDRAW_WALLET",
"currency":"USDT",
"localOrderId":"conan41123",
"merchantActualAmount":"31.45",
"merchantCurrency":"USDT",
"merchantId":302992856974,
"merchantPaidAmount":"4",
"merchantUserId":"conan",
"notifyTime":1772364467800,
"orderCreateTime":1772364292167,
"orderId":"474083263103237",
"status":"SUCCESS",
"type":"WITHDRAW",
"userAmount":"28.37",
"userCurrency":"USDT",
"userReceivableAmount":"28.37",
"walletUserId":4603,
"sign":"bc92191367449df36920178e05731a6b",
"key":"9yUreYgTRtit39Dy"
}

当您收到回调通知后，请在处理完成后直接返回字符串 success，表示已成功接收并处理该消息。系统在收到 success 响应后，将不再对该笔回调进行重复发送。若未收到期望响应（未返回 success 或返回异常），系统将按照阶梯式重试机制重新发送回调通知，最多重试 14 次。当前重试时间间隔依次为： 15s, 15s, 30s,180s, 600s, 1200s, 1800s, 1800s, 1800s,3600s,10800s,10800s,21600s, 21600s

请求参数​

请求 json 样例​

响应data 参数说明​

orderBizType 类型说明：​

回调返回 json 数据​